'\" t
.\"     Title: pacemaker-controld
.\"    Author: Andrew Beekhof <andrew@beekhof.net>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/27/2020
.\"    Manual: Pacemaker Configuration
.\"    Source: Pacemaker Configuration
.\"  Language: English
.\"
.TH "PACEMAKER\-CONTROLD" "7" "03/27/2020" "Pacemaker Configuration" "Pacemaker Configuration"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pacemaker-controld \- controller properties
.SH "SYNOPSIS"
.PP
[\fBdc\-version\fR=string] [\fBcluster\-infrastructure\fR=string] [\fBdc\-deadtime\fR=time] [\fBcluster\-recheck\-interval\fR=time] [\fBload\-threshold\fR=percentage] [\fBnode\-action\-limit\fR=integer] [\fBelection\-timeout\fR=time] [\fBshutdown\-escalation\fR=time] [\fBjoin\-integration\-timeout\fR=time] [\fBjoin\-finalization\-timeout\fR=time] [\fBtransition\-delay\fR=time] [\fBstonith\-watchdog\-timeout\fR=time] [\fBstonith\-max\-attempts\fR=integer]
.SH "DESCRIPTION"
.PP
Cluster properties used by Pacemaker\*(Aqs controller, formerly known as crmd
.SH "SUPPORTED PARAMETERS"
.PP
\fBdc\-version\fR = string [none]
.RS 4
Version of Pacemaker on the cluster\*(Aqs DC\&.
.sp
Includes the hash which identifies the exact changeset it was built from\&. Used for diagnostic purposes\&.
.RE
.PP
\fBcluster\-infrastructure\fR = string [corosync]
.RS 4
The messaging stack on which Pacemaker is currently running\&.
.sp
Used for informational and diagnostic purposes\&.
.RE
.PP
\fBdc\-deadtime\fR = time [20s]
.RS 4
How long to wait for a response from other nodes during startup\&.
.sp
The "correct" value will depend on the speed/load of your network and the type of switches used\&.
.RE
.PP
\fBcluster\-recheck\-interval\fR = time [15min]
.RS 4
Polling interval for time based changes to options, resource parameters and constraints\&.
.sp
The Cluster is primarily event driven, however the configuration can have elements that change based on time\&. To ensure these changes take effect, we can optionally poll the cluster\*(Aqs status for changes\&. Allowed values: Zero disables polling\&. Positive values are an interval in seconds (unless other SI units are specified\&. eg\&. 5min)
.RE
.PP
\fBload\-threshold\fR = percentage [80%]
.RS 4
The maximum amount of system resources that should be used by nodes in the cluster
.sp
The cluster will slow down its recovery process when the amount of system resources used (currently CPU) approaches this limit
.RE
.PP
\fBnode\-action\-limit\fR = integer [0]
.RS 4
The maximum number of jobs that can be scheduled per node\&. Defaults to 2x cores
.RE
.PP
\fBelection\-timeout\fR = time [2min]
.RS 4
*** Advanced Use Only ***\&.
.sp
If need to adjust this value, it probably indicates the presence of a bug\&.
.RE
.PP
\fBshutdown\-escalation\fR = time [20min]
.RS 4
*** Advanced Use Only ***\&.
.sp
If need to adjust this value, it probably indicates the presence of a bug\&.
.RE
.PP
\fBjoin\-integration\-timeout\fR = time [3min]
.RS 4
*** Advanced Use Only ***
.sp
If need to adjust this value, it probably indicates the presence of a bug
.RE
.PP
\fBjoin\-finalization\-timeout\fR = time [30min]
.RS 4
*** Advanced Use Only ***
.sp
If you need to adjust this value, it probably indicates the presence of a bug
.RE
.PP
\fBtransition\-delay\fR = time [0s]
.RS 4
*** Advanced Use Only *** Enabling this option will slow down cluster recovery under all conditions
.sp
Delay cluster recovery for the configured interval to allow for additional/related events to occur\&. Useful if your configuration is sensitive to the order in which ping updates arrive\&.
.RE
.PP
\fBstonith\-watchdog\-timeout\fR = time [(null)]
.RS 4
How long to wait before we can assume nodes are safely down
.RE
.PP
\fBstonith\-max\-attempts\fR = integer [10]
.RS 4
How many times stonith can fail before it will no longer be attempted on a target
.RE
.SH "AUTHOR"
.PP
\fBAndrew Beekhof\fR <\&andrew@beekhof\&.net\&>
.RS 4
Author.
.RE
